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Abstract 


TSLIB  is  a  C  application  programming  interface  (API)  for  a 
flat-panel,  touch  screen  input  device  manufactured  by  MicroTouch®. 
Unlike  most  software  drivers  for  this  device,  the  TSLIB  interface  is 
not  designed  to  be  a  transparent  replacement  for  a  mouse  input 
pointer.  The  TSLIB  interface  supports  not  only  single-point  input, 
but  also  continuous-point  input  to  facilitate  support  for  gesture-type 
input  data  in  a  multimodal,  interactive  environment.  Also,  unlike 
most  software  drivers  for  this  device,  the  TSLIB  software  runtime 
support  does  not  reside  in  the  kernel/driver  space  of  the  operating 
system.  The  intent  of  the  TSLIB  design  is  to  place  the  software 
interface  driver  in  the  user  application  space  and  connect  to  the 
physical  device  via  the  operating-system-supplied  APIs  for  serial 
devices.  Because  the  TSLIB  API  does  not  operate  at  the  device  driver 
level  of  the  operating  system,  the  interface  source  code  can  be  easily 
ported  across  multiple  hardware  platforms  and  multiple  software 
operating  systems.  The  source  code  is  designed  for  use  on  various 
UNIX  platforms,  including  IRIX®,  Solaris™,  and  LINUX,  as  well  as 
under  MS-DOS  and  Windows  NT.  A  description  of  all  API  functions, 
data  structures,  and  design  algorithms  is  presented. 


11 


Contents 


1.  Introduction . 

2.  Technical  Background  of  MicroTouch®  Touch  Screen . 

2.2  The  Touch  Screen  Hardware  Interface . 

2.2  General  Protocol . 

2.3  The  Touch  Screen  Coordinate  System . 

3.  TSLIB — Touch  Screen  API  Descriptions . 

3.2  Summary  of  a  Typical  Touch  Screen  Application  Thread  .. 

3.2  TSLIB  Data  Types . 

3.2.2  TouchScreen . 

3.2.2  TSPoint . 

3.3  TSLIB  User  API  Functions . 

3.4  TSLIB  Low-Level  Functions . 

4.  Touch  Screen  Utilities . 

4.2  tslnit — To  Initialize  MicroTouch  Touch  Screen  Controller 

4.2  tsDiag — To  Talk  to  Touch  Screen  Controller . 

5.  Source  Code . 

5.2  TSLIB  Source . 

5.2  Some  Test  Programs  for  TSLIB . 

Distribution . 

Report  Documentation  Page . 


.  1 

.  2 

.  2 
.2 
.  3 

.  4 

.  4 
.  5 
.  5 
.  7 
.  7 
22 

14 

14 

14 

15 

25 

24 

27 

29 


1.  Introduction 


TSLIB  is  a  C  application  programming  interface  (API)  for  a  flat-panel, 
touch  screen  input  device  manufactured  by  MicroTouch®.  Unlike  most 
software  drivers  for  this  device,  the  TSLIB  interface  is  not  designed  to  be 
a  transparent  replacement  for  a  mouse  input  pointer.  Mouse  input  devices 
and  their  software  interfaces  are  intended  to  be  single-point-at-a-time 
input  devices.  The  TSLIB  interface  supports  not  only  single-point  input, 
but  also  continuous-point  input  to  facilitate  support  for  gesture-type 
input  data  in  a  multimodal,  interactive  environment.  Also,  unlike  most 
software  drivers  for  this  device,  the  TSLIB  software  runtime  support  does 
not  reside  in  the  kernel/ driver  space  of  the  operating  system.  The  intent 
of  the  TSLIB  design  is  to  place  the  software  interface  driver  in  the  user 
application  space  and  to  connect  to  the  physical  device  via  the  operating- 
system-supplied  APIs  for  serial  devices.  Because  the  TSLIB  API  does  not 
operate  at  the  device  driver  level  of  the  operating  system,  the  interface 
source  code  can  be  easily  ported  across  multiple  hardware  platforms  and 
multiple  software  operating  systems.  The  source  code  is  designed  to  be 
used  on  various  UNIX  platforms,  including  IRIX®,  Solaris™,  and  LINUX, 
as  well  as  under  MS-DOS  and  Windows  NT.  A  detailed  description  of  all 
API  functions  and  data  structures  is  presented.  When  the  level  of  com¬ 
plexity  of  the  logic  warrants  more  detail,  pertinent  algorithms  are  shown 
within  the  particular  functional  description. 
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2.  Technical  Background  of  MicroTouch  Touch  Screen 

Section  2.1  briefly  describes  the  touch  screen  controller  hardware  inter¬ 
face.  The  message  protocols  for  the  controller  are  described  in  section  2.2, 
and  a  technical  note  regarding  the  touch  screen  coordinate  system  is 
presented  in  section  2.3. 

2.1  The  Touch  Screen  Hardware  Interface 

The  touch  screen  controller  interfaces  to  the  CPU  platform  via  a  standard 
RS-232  serial  data  connection.  The  application  library  connects  to  the 
interface  by  calling  the  operating  system  interface  functions  that  control 
communication  with  a  serial  device.  The  touch  screen  data  packets  are 
buffered  at  four  levels: 

1.  The  hardware  device  usually  has  a  2-  to  32-byte  data  buffer,  depending 
on  the  UART. 

2.  The  operating  system  usually  has  a  dynamically  resizable  data  buffer. 

3.  TSLIB  has  a  512-byte  input/ output  (1/ O)  data  buffer. 

4.  TSLIB  has  a  5000-point  data  buffer,  which  is  good  for  at  least  25  s  of 
continuous,  nonstop  pointing  at  9600  baud. 

On  hardware  reset,  the  controller  takes  on  the  following  initial  conditions: 

•  serial  port:  no  parity,  7  data  bits,  2  stop  bits,  and  9600  baud; 

•  autobaud  detection  enabled;  and 

•  data  packet  protocol:  mode  stream  and  format  decimal. 

TSLIB  software  reset  changes  the  initial  conditions  (as  suggested  by 
MicroTouch)  to 

•  serial  port:  no  parity,  8  data  bits,  1  stop  bit,  and  9600  baud; 

•  autobaud  detection  disabled;  and 

•  data  packet  protocol:  mode  stream  and  format  tablet. 

2.2  General  Protocol 

The  MicroTouch  controller  uses  two  types  of  communication  packet 
formats: 

Type  1 — The  control  packet  is  used  to  establish  controller  configuration 
parameters.  This  type  of  packet  is  used  almost  exclusively  for  setup  and 
initialization  of  the  controller.  TSLIB  will  send  a  control  packet  of  the 
form 

<SOH>command<CR>  , 
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where  the  command  is  a  short  ASCII  string  indicating  the  type  of  opera¬ 
tion  to  perform. 

The  controller  sends  a  reply  back  to  TSLIB  in  the  same  format,  where  the 
command  is 

•  "0,"  indicating  successful  command  completion; 

•  "1,"  indicating  failure;  or 

•  some  other  text  string,  indicating  an  informational  reply. 

For  example,  to  request  controller  identity,  TSLIB  sends  <S0H>0I<CR>,  and 
the  controller  replies  <SOH>A30550<cr>  . 

Type  2 — The  data  packet  is  used  to  send  touch  screen  coordinates  from 
the  controller  to  TSLIB.  The  packet  is  always  5  bytes  long,  represented  as 
SXxYy  and  interpreted  as  follows: 

•  SO,  SI — touch  pen  (not  used  in  this  software); 

•  S2-S4 — reserved; 

•  S5 — pen  or  finger  (not  used); 

•  S6 — 1  =  PenDown,  0  =  PenUp; 

•  S7 — always  1  (sync  bit); 

•  X0-X6  =  lsb,  x0-x6  =  msb;  and 

•  Y0-Y6  -  lsb,  y0-y6  =  msb. 

The  Touch  Screen  Coordinate  System 

Under  TSLIB,  the  touch  screen  controller  returns  data  values  that  have 
14-bit  resolution  and  fall  in  the  range  of  0  to  16383.  The  origin  (0,0)  is 
located  in  the  lower  left  corner  of  the  display  screen.  Each  data  point 
collected  by  the  controller  can  have  one  of  three  states: 

1.  PenDown — The  finger  is  now  touching  the  screen  after  previously  being 
in  the  PenUp  state  (i.e.,  the  first  point  of  a  line); 

2.  PenContinue — The  finger  is  now  touching  the  screen  after  previously 
being  in  the  PenDown  state  (i.e.,  the  fth  point  of  a  line,  but  not  the  first 
point);  or 

3.  PenUp — The  finger  is  not  touching  the  screen  after  previously  being  in 
the  PenContinue  state  (i.e.,  the  last  point  of  a  line). 
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3.  TSLIB — Touch  Screen  API  Descriptions 

The  touch  screen  API  is  presented  as  both  a  user's  reference  document 
and  a  reference  for  the  algorithmic  design.  Section  3.1  shows  a  simple 
example  of  API  usage  in  a  typical  processing  thread.  Section  3.2  intro¬ 
duces  two  new  data  types  established  by  this  API,  and  section  3.3  lists  all 
API  methods,  including  calling  syntax  and  semantics,  as  well  as  basic 
design  algorithms. 

3.1  Summary  of  a  Typical  Touch  Screen  Application  Thread 

A  minimal  touch  screen  application  thread  would  use  the  TSLIB  API  in 
the  following  manner: 

1.  Call  tsOpen  to  create  an  instance  of  a  Touchscreen  on  a  particular 
RS232  port.  Call  tsClose  to  delete  the  instance. 

2.  Call  tsSetScreenSize  to  set  the  scaling  into  some  user  pixel  coordinate 
system.  Other  tsSetXxxx  functions  can  be  optionally  invoked  for  modify¬ 
ing  the  behavior  of  the  TouchScreen  device. 

3.  Call  tsOnPenUp  to  set  up  user  callback  for  a  PenUp  (called  when  finger 
lifts  from  the  screen)  event.  Other  callbacks  are  available  for  PenDown 
and  PenContinue  events. 

4.  Call  tsAppLoop  to  wait  for  data.  Typically,  this  routine  will  never  return 
unless  an  error  occurs  or  tsSetAppLoopAbort  is  invoked.  The  routine 
tsSetAppMode  can  be  used  to  modify  this  behavior. 

5.  When  a  finger  is  lifted,  the  user  callback  routine  will  receive  the 
TouchScreen  context,  a  userArgument  (uArg,  typically  the  user 
application  context),  the  x,  y  coordinate  in  user  units  of  the  last  point,  and 
the  number  of  points  that  were  collected  (after  data  filtering)  between  the 
PenDown  and  the  PenUp  events.  If  desired,  tsGetLine  can  be  called  to 
retrieve  the  entire  line  and  tsGetPenTime  can  be  used  to  determine  the 
time  at  which  the  line  was  drawn. 

For  example,  the  sample  program  that  follows  attaches  to  the  touch 
screen  controller  on  UNIX  serial  port  /dev/ tty  a.  It  sets  the  user  screen 
units  to  1280  x  1024  pixels.  The  data  filter  is  set  to  require  the  pen  (finger) 
to  move  at  least  five  pixels  in  either  the  x  (horizontal)  or  y  (vertical) 
direction  before  recording  the  data  point.  The  pixel  location  and  the 
number  of  points  drawn  from  PenDown  to  PenUp  is  printed  every  time 
the  pen  is  lifted  from  the  screen.  If  the  user  touches  the  lower  right  corner 
of  the  screen,  the  program  exits. 
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#include  <stdio.h> 

#include  <touchscreen . h> 

/*  pen  UP  callback  handler  */ 

void  PenUpCB (  Touchscreen  h,  int  unused,  TSPoint  pt ,  int  In  ) 

{ 

print f ( "PenUp  X=%d,  Y=%d,  lineLen=%d  ) \n" ,  pt.x,  pt.y,  In 
)  ; 

if (  pt.x  >1260  &&  pt.y  <  20  ) tsSetAppLoopAbort (  h  ); 

} 

main (  int  argc,  char  **argv  ) 

{ 

Touchscreen  h; 
h  =  tsOpen(  "/dev/ttya"  ); 
if (  h  !=  NULL  ) 

{ 

/*  set  scaling,  filter,  PenUp  callback  */ 
tsSetScreenSize (  h,  1280,  1024  ); 
tsSetDataFilter (  h,  5  ); 
tsOnPenUp(  h,  PenUpCB,  0  ); 

/*  process  touch  screen  events  * 
tsAppLoop (  h  ) ; 
tsClose (  h  ) ; 

} 

} 

Note:  Additional  examples  can  be  found  in  the  test  code  examples  located 
in  source  files  tstestl.c  and  tstest2.c  (see  sect.  5.2). 

3.2  TSLIB  Data  Types 

TSLIB  introduces  two  new  data  types,  TouchScreen  and  TSPoint.  Each 
type  is  described  below  in  terms  of  its  individual  components.  When 
applicable,  the  component  initialization  is  shown  in  parentheses  immedi¬ 
ately  following  the  component  name. 

3.2.1  TouchScreen 

Description:  Context  for  a  touch  screen  object  (file:  touchscreen.h). 
Components 

I/O  context 

TTYCTX  port  (init:  NULL) — I/O  port  context 

char  iobuf[512]  (init:  NONE) — input  buffer  for  information  from  device 
int  iobufLen  (init:  0) — number  of  entries  in  iobuf 

char  iostat[512]  (init:  iostat[0]  =  0) — NULL-terminated  string  with  the  last 
response  from  the  device 

int  lostSync  (init:  0) — count  of  lost  data  packets 
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Scaling  and  filtering  behavior  and  line  attributes 
int  filter  (init:  1) — line  filter 

int  scrX,  scrY  (init:  16383, 16383,  i.e.,  3fff,  3fff) — maximum  number  of 
pixels  on  screen 

float  scaleX,  scaleY  (init:  1.0, 1.0  ) — scale  factor  to  get  to  user  scaled  units 

(Note:  No  translation  assumes  that  the  origin  of  the  user  space  is  always 

(0,0).) 

TSPoint  line  [5000]  (init:  NONE) — internal  line  buffer  for  current  line 

(Note:  Allows  for,  at  most,  25  s.  If  line  gets  full,  then  generate  an  auto 
PenUp.) 

int  lineLen  (init:  0) — current  length  of  line 

int  timePenDown  (init:  0) — time  when  pen  went  down 

int  timePenUp  (init:  0) — time  when  pen  went  up 

int  linelD  (init:  0) — current  line  ID  (probably  just  an  index  counter) 

int  penState  (init:  1) — current  pen  state 

1 —  TSPenStateUp,  finger  is  up 

2 —  TSPenStateDown,  finger  is  down  on  first  point 

3 —  TSPenStateContinue,  finger  is  down  on  zth  point 
Callback 

int  appMode  (init:  1) — when  to  return  from  tsAppLoop 

1 —  TSAppModeReturnOnlyOnError 

2 —  TSAppModeReturnOnPenUp 

3 —  TSAppModeRetumOnPenChange 

int  appAbortFlag  (init:  0) — if  not  zero  and  PenUp  then  abort  AppLoop 
void  (*userCBPenDown)  (TouchScreen  h,  int  uArg,  TSPoint  now) 

(init:  NULL) — user  callback,  PenDown 

void  (*userCBPenContinue)(TouchScreen  h,  int  uArg,  TSPoint  now) 

(init:  NULL) — user  callback,  PenContinue 

void  (*userCBPenUp)(TouchScreen  h,  int  uArg,  TSPoint  now,  int  lineLen) 
(init:  NULL) — user  callback,  PenUp 

int  PenDownCBArg,  int  PenContinueCBArg,  PenUpCBArg — user  CB  Arg 


3.2.2  TSPoint 


Description:  touch  screen  data  point  used  in  a  line  (file:  tspoint.h). 
Components 

int  x — x  coordinates  of  a  point  in  user  scaled  units 
int  y — y  coordinates  of  a  point  in  user  scaled  units 

3.3  TSLIB  User  API  Functions 

Individual  function  descriptions  of  the  API  given  here  are  sorted  alpha¬ 
betically  by  function  name. 

int  tsAppLoop (Touchscreen  h) 

Description:  Wait  for  data  events  from  the  touch  screen. 

Returns:  This  function  normally  runs  forever.  The  routine  tsSetAppMode 
can  change  this. 

Algorithm 

Local  variables 

int  status — status  returned  from  getting  next  point  buffer 

TSPoint  pt — point  just  returned  in  user  units 

TSPoint  nowPt — previous  point  returned  in  user  units 

in  a  loop  process  data  points 

if  penState  is  PenUp  and  abortFlag  is  set  then 
return  with  appLoopAbort  error 
get  next  point  buffer 

if  status  indicates  not  a  point  return  error  (never 
happens ! ) 

pt  =  convert  point  buffer  to  point  in  user  space 
if  current  lineLen  >  0  then 
nowPt  =  line  [  lineLen- 1] 

filter  data  based  on  distance  between  pt  to  nowPt 
if  no  change,  then  ignore  this  point (goto  end  of  loop) 
if  point  is  with  pen  up  then 
set  penState  to  PenUp 
store  point  into  line [lineLen] 
increment  lineLen 
record  timePenUp 
call  user  callback  if  installed 
return  if  appmode  requires  it 
else  if  previous  state  was  PenUp 
set  penState  to  PenDown 
store  point  into  line  [0] 
lineLen  =  1 
record  timePenDown 
call  user  callback  if  installed 
return  if  appmode  requires  it 
else 
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set  penState  to  PenContinue 
store  point  into  line  [lineLen] 
increment  lineLen 
if  lineBuffer  full  then 

change  penState  to  PenUp 
call  user  callback  if  installed 
return  if  appmode  requires  it 
end  of  loop 

int  tsClose (Touchscreen  h) 

Description:  Destroys  touch  screen. 

Returns:  If  error,  returns  -1;  else  returns  0. 

Algorithm 

If  context  is  not  NULL  then 

if  I/O  port  is  opened,  then  close  it 
de-allocate  context 

int  tsDoCalibration (Touchscreen  h) 

Description:  Performs  interactive  internal  calibration  (needs  standout  for 
prompts),  requiring  user  to  poke  first  at  the  lower  left  corner  of  the  screen 
and  then  at  the  upper  right  comer  of  the  screen. 

(Note:  This  function  is  probably  not  used  by  most  applications.) 

Returns:  If  error,  returns  -1;  else  returns  0. 

int  tsGetFd (Touchscreen  h) 

Description:  Get  file  descriptor  associated  with  I/O  port. 

Returns:  If  error,  returns  - 1 ;  else  returns  file  descriptor. 

char  *tsGetLastControllerMessage (Touchscreen  h) 

Description:  Get  last  ASCII  text  message  from  the  MicroTouch  controller. 

Returns:  Returns  a  pointer  to  a  NULL-terminated  ASCII  text  string. 

int  tsGetLine (Touchscreen  h,  TSPoint  *line,  int 
maxline) 

Description:  Get  current  line.  The  parameter  maxline  indicates  the  num¬ 
ber  of  elements  the  user's  receiving  line  buffer  can  hold. 

Returns:  If  error,  returns  -1;  else  returns  0. 

int  tsGetLinelD (Touchscreen  h) 

Description:  Get  ID  of  current  line. 

Returns:  If  no  line,  returns  -1;  else  returns  line  ID. 


int  tsGetLineLength (Touchscreen  h) 

Description:  Get  current  line  length  (number  of  points  in  line  buffer  since 
most  recent  PenDown). 

Returns:  If  error,  returns  -1;  else  returns  0. 

int  tsGetPenState (Touchscreen  h) 

Description:  Get  current  pen  state. 

Returns:  PenStates  are  described  below  (then  lists  pen  state  descriptions). 

int  tsGetPenTime (Touchscreen  h,  int  *timeDown,  int 
* time Up) 

Description:  Get  the  times  associated  with  the  last  PenDown  and  PenUp 
events.  Time  information  is  to  help  support  multimodal  gesture 
correlation. 

Returns:  If  error,  returns  -1;  else  returns  0. 

TSPoint  tsGetPoint (Touchscreen  h) 

Description:  Get  current  point  (or  NULL  if  none). 

Returns:  If  no  point,  returns  (-99999,  -99999);  else  returns  x,  y  of  current 
point. 

Algorithm 

Allocate  context 

if  lineLen  >  0  then 

return  line [lineLen-1] 

else 

return  (-99999,99999) 

int  tsGetLostSyncCount (Touchscreen  h) 

Description:  Get  count  of  data  packets  lost  by  interface. 

Returns:  If  error,  returns  -1;  else  returns  lostSync  count. 

int  tsOnPenContinue (Touchscreen  h,  void  (*SvcHndl) 
(Touchscreen  h,  int  uArg,  TSPoint  now) ,  int  uArg) 

Description:  Set  user  callback  function  for  PenContinue  event. 
PenContinue  is  when  the  finger  is  touching  the  screen,  and  it  is  not  the 
initial  point. 

Returns:  If  error,  returns  -1;  else  returns  0. 
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int  tsOnPenDown (TouchScreen  h,  void  (*SvcHndl) 
(Touchscreen  h,  int  uArg,  TSPoint  now) ,  int  uArg) 

Description:  Set  user  callback  function  for  PenDown  event.  PenDown  is 
when  the  user  first  touches  the  screen. 

Returns:  If  error,  returns  -1;  else  returns  0. 

int  tsOnPenUp (TouchScreen  h,  void  (*SvcHndl) 
(TouchScreen  h,  int  uArg,  TSPoint  now,  int 
lineLength) ,  int  uArg) 

Description:  Set  user  callback  function  for  PenUp  event.  PenUp  is  when 
the  finger  is  lifted  off  the  screen. 

Returns:  If  error,  returns  -1;  else  returns  0. 

TouchScreen  tsOpen (char  *nameOf SerialPort ) 

Description:  Create  a  new  touch  screen  on  some  serial  port. 

Returns:  If  error,  returns  -1;  else  returns  0. 

Algorithm 

Allocate  context 

return  error  if  memory  allocation  problem 
initialize  context  to  default  state  (see  TouchScreen 
datatype) 
attach  I/O  Port 
if  error  then 

deallocate  context  and  return  error 
else  return  context 

int  tsReset (TouchScreen  h) 

Description:  Send  reset  hardware  commands  to  touch  screen,  which 
include 

hardware  reset; 
autobaud  disable; 

9600  baud,  no  parity,  8  data  bits,  and  1  stop  bit;  and 

data  format:  stream  mode  and  format  tablet. 

Returns:  If  error,  returns  negative  value;  else  returns  0. 

(Note:  This  function  is  probably  not  used  by  most  applications.) 

void  tsSetAppLoopAbort (TouchScreen  h) 

Description:  Set  appAbortFlag  so  that  tsAppLoop  will  return  pen  state 
equals  PenUp. 

Returns:  Nothing  is  returned. 


int  tsSetAppMode (Touchscreen  h,  int  appMode) 

Description:  Set  behavior  for  tsAppLoop.  See  description  above  for 
possibilities. 

Returns:  If  error,  returns  -1;  else  returns  0. 

(Note:  This  routine  is  probably  never  used.  It  is  provided  as  an  alternative 
to  the  callback  mechanism.) 

int  tsSetDataFilter (Touchscreen  h,  int 
distancelnScaledUnits) 

Description:  Do  not  store  data  in  line  unless  xor  y  coordinate  changes  by 
distancelnScaledUnits. 

(Note:  A  good  value  for  a  1280  x  1024  screen  seems  to  be  between  5  and 
10.  Another  possible  filter  would  be  the  locking  of  the  data  to  some  user- 
specified  grid  increment  and  only  passing  through  data  that  have 
changed  a  grid  unit  in  one  of  the  directions.) 

Returns:  If  error,  returns  -1;  else  returns  0. 

int  tsSetScreenSize (Touchscreen  h,  int  xmax,  int  ymax) 
Description:  Set  size  of  screen  in  pixels  for  scaled  units. 

Returns:  If  error,  returns  -1;  else  returns  0. 

Algorithm 

Save  new  xmax  and  ymax  into  context 
Calculate  scaleX  and  scaleY  by  dividing 

each  max  by  fullscale  (i.e.  14  bits,  16383,  0x3fff) 

TSLIB  Low-Level  Functions 


int  tsDistance(  int  pi,  int  p2,  int  distance) 

Description:  Determines  if  difference  between  pi  and  p2  is  greater  than 
distance. 

Returns:  If  absolute Value(fl  -  b)  is  greater  than  or  equal  to  dist,  returns  1; 
else  returns  0. 

TSBufToPoint(  char  *bf,  float  scaleX,  float  scaleY ) 

Description:  Converts  Microtouch  table  formatted  data  to  TSPoint. 

Note:  MicroTouch  data  format  is  SXxYy,  where 
SO,  SI  for  touch  pen  (not  used); 

S2-S4 — reserved ; 

S5 — pen  or  finger  (not  used); 


•  S6 — 1  =  touchDown,  0  =  touchUp; 

•  S  7  always  1  (sync  bit); 

•  X0-X6  =  lsb,  x0-x6  =  msb;  and 

•  Y0-Y6  =  lsb,  y0-y6  -  msb. 

Returns:  Converts  x  and  y  to  user  units  and  returns  the  point. 

Algorithm 

pt.x  =  (int) (.5  +  (scaleX  *  (float) tsEvalBuffer (  bf+1  ))) 
pt.y  =  (int) (.5  +  (scaleY  *  (float) tsEvalBuffer (  bf+3  ))) 

int  tsEvalBuffer (char  *v) 

Description:  Converts  2-character  buffer  data  to  a  14-bit  integer. 
Returns:  Computed  14-bit  integer. 

Algorithm 

( ( ( int) v [0] )  &  0x7f)  |  (  ( (int) v [1] )  «  7) 

tsGetPointBuf f er (port ,  char  *buf,  int  bufsize) 

Description:  Read  a  data  packet  from  the  I/O  port.  This  version  does 
error  checking  and  recovers  from  loss  data  if  the  processor  cannot  keep 
up  with  the  I/O  rates  (192  packets/ s  at  9600  baud). 

Returns:  -1  indicates  an  error  (never  occurs,  because  not  implemented), 
and  0  indicates  5-byte  data  packet  SXxYy,  where 

•  SO,  SI  for  touch  pen  (not  used); 

•  S2-S4 — reserved; 

•  S5 — pen  or  finger  (not  used); 

•  S6 — 1  =  penDown,  0  =  PenUp; 

•  S7  always  1  (sync  bit); 

•  X0-X6  =  lsb,  x0-x6  =  msb;  and 

•  Y0-Y6  =  lsb,  y0-y6  =  msb. 

Algorithm 

Five  states 

SyncData — looking  for  sync  byte 
LsbX — looking  for  IsbX 
MsbX — looking  for  msbX 
LsbY — looking  for  IsbY 
MsbY — looking  for  msbY 


state  =  SyncData 
In  a  loop 

data  =  get  next  byte 
if  error  reading  data  return  -1 
if  data  sign  bit  is  set  then 
state  =  SyncData 
if  state  is  SyncData 
if  data  sign  bit  is  set 
buf [0]  =  data 
state  =  LsbX 
else  if  state  is  LsbX 
buf [1]  =  data 
state  =  MsbX 
else  if  state  is  MsbX 
buf [2]  =  data 
state  =  LsbY 
else  if  state  is  LsbY 
buf [3]  =  data 

state  =  MsbX 
else  if  state  is  LsbX 
buf [4]  =  data 

return  0  (indicates  point  was  found) 
end  loop 


4.  Touch  Screen  Utilities 


Two  low-level  diagnostic  utilities  are  provided  for  initializing  the  touch 
screen  and  for  sending  low-level  messages  to  the  hardware  controller. 

4.1  tslnit — To  Initialize  MicroTouch  Touch  Screen 
Controller 

Usage:  tslnit  <ttport>  example:  tslnit/dev/ttya 

Algorithm 

get  UNIX  port  name  from  command  line  argfl] 
open  port 

if  error  print  error  message  and  exit 
send  init  sequence  commands  including 

•  R  -  reset 

•  AD  -  disable  autobaud 

•  PN812  -  no  parity,  8  data  bits,  1  stop  bit,  9600 

•  FT  -  use  format  tablet  data  mode 

•  MS  -  stream  data 

close  port 
exit 

4.2  tsDiag — To  Talk  to  Touch  Screen  Controller 

Usage:  tsDiag  <ttport>  example:  tsDiag/dev/ttyb 

Algorithm 

get  UNIX  port  name  from  command  line  arg[l] 
open  port 

if  error  print  error  message  and  exit 
in  a  loop 

prompt  and  wait  for  keyboard  command 
if  command  is  QUIT  then  break  loop 
else  if  command  is  DATA  then 

wait  and  read  one  line  segment  (getData  function) 
else  if  command  is  CX  then 
send  <S0H>CX<CR> 

wait  for  3  replies  (ack,  lowerleft,  upperright) 

else 

send  SOH  <command>  <CR>  to  controller 
wait  for  reply 
Print  reply 

end  loop 
close  port 
exit 
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5.  Source  Code 


The  current  version  of  the  source  code  at  the  time  of  this  writing  is  listed 
below,  followed  by  some  test  programs  for  TSLIB. 

5.1  TSLIB  Source 


file:  tslibl.c 
Date:  Jan  14,  2000 

Jan  19,  2000  add  TSAppLoopAbort ,  pen  time 

touch  screen  application  interface  for  MicroTouch  controller 


*/ 

#include  <tspoint.h> 
ftinclude  <unixtty.h> 
#include  <sys/types . h> 
#include  <time.h> 


#def ine  SYNCFLAG  0x80 
#define  SOH  1 


#define  StateSyncData  1 
#define  StateLsbX  2 
#define  StateMsbX  3 
#define  StateLsbY  4 
#define  StateMsbY  5 

#define  TSBufMax  512 
#define  TSLineMax  5000 

#def ine  TS_LIB_SYS_DEF 
typedef  struct  tsctx 
{ 

/*  —I/O  context  */ 

TTYCTX  tty;  /*  I/O  port  */ 

char  iobuf [TSBufMax] ;  /*  input  buffer  for  information  from  device  */ 
int  iobuf Len;  /*  number  of  entries  in  iobuf  */ 

char  iostat  [TSBufMax]  ;  /*  null  terminated  string  with  last  response  from 
device  */ 

int  lostSync;  /*  stats  on  how  much  data  is  loss  */ 


/*  —Scaling  and  filtering  behavior  and  line  attributes  */ 
int  filter;  /*  line  filter  */ 

int  scrX,  scrY;  /*  user  spec,  max  pixels  of  screen  */ 

float  scaleX,  scaleY;  /*  scale  factor  to  get  to  user  scaled  units  */ 

TSPoint  line [TSLineMax] ;  /*  internal  line  buffer  for  current  line  */ 

/*  note:  If  line  gets  full  generate  auto  PenUp.  */ 

int  lineLen;  /*  current  length  of  line  */ 

int  line ID;  /*  current  line  ID  (probably  just  an  index  counter)  */ 

int  penState;  /*  current  pen  state  */ 

int  timePenDown;  /*  when  finger  touched  screen  */ 

int  timePenUp;  /*  when  finger  lifted  from  screen  */ 
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/*  —Callback  */ 

int  appMode;  /*  when  to  return  from  tsAppLoop  */ 

int  appAbortFlag;  /*  if  not  zero,  abort  appModeLoop  on  PenUP  */ 

void  (*userCBPenDown)  (  struct  tsctx  *h,  int  uArg,  TSPoint  now  )  ; 

void  (*userCBPenContinue) (  struct  tsctx  *h,  int  uArg,  TSPoint  now  ) ; 

void  (*userCBPenUp) {  struct  tsctx  *h,  int  uArg,  TSPoint  now,  int  lineLen  ) 

int  penDownCBArg ,  penContinueCBArg,  PenUpCBArg; 

}  TSCTX; 

#include  <touchscreen.h> 

#include  <stdlib.h> 

#include  <stdio.h> 

#include  <string.h> 

Touchscreen  tsOpen(  char  *nameOf SerialPort  ) 

{ 

Touchscreen  h; 

h  =  (Touchscreen) calloc (  1,  sizeof  (  TSCTX  )  ); 
if (  h  ==  NULL  ) return  NULL; 

h->iostat  [0]  =  0; 
h->iobufLen  =  0; 
h->lostSync  =  0; 

h->penState  =  TSPenStateUp ; 
h->lineID  =  -1; 
h->lineLen  =  0; 
h->timePenDown  =  0; 
h->timePenUp  =  0; 

h->scaleX  =  1.0;  h->scaleY  =  1.0; 

h->scrX  =  TSFullScale;  h->scrY  =  TSFullScale; 

h->filter  =  1; 

h->appMode  =  TSAppModeReturnOnlyOnError; 
h->appAbortFlag  =  0; 
h- >userCBPenDown  =  NULL; 
h->userCBPenContinue  =  NULL; 
h- >userCBPenUp  =  NULL; 

h->penDownCBArg  =  h- >penContinueCBArg  =  h- >PenUpCBArg  =  0; 

h->tty  =  openTTY (  nameOf SerialPort  ); 
if (  h->tty  ==  NULL  ) 

{ 

free (  h  ) ; 
h  =  NULL; 

} 

return  h; 

} 

int  tsClose(  Touchscreen  h  ) 

{ 

if (  h  ! =  NULL  ) 

{ 

if (  h- >tty  ! =  NULL  )closeTTY(  h->tty  ); 
free (  h  ) ; 

} 

} 
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int  tsReset (  Touchscreen  h  ) 

{ 

if (  0  ! =  tsPutCmdGetReply (  h,  "R"  )  ) return  -1; 

iff  0  !=  tsPutCmdGetReply (  h,  "AD"  )  ) return  -2; 

iff  0  ! =  tsPutCmdGetReply (  h,  "PN812"  )  ) return  -3; 

iff  0  ! =  tsPutCmdGetReply (  h,  "FT"  )  ) return  -4; 
iff  0  ! =  tsPutCmdGetReply (  h,  "MS"  )  ) return  -5; 
return  0 ; 

} 

int  tsDoCalibration (  Touchscreen  h  ) 

printf ( "Begin  Touchscreen  low  level  calibrat ion\n" ) ; 
if  {  0  ==  tsPutCmdGetReply {  h,  "CX"  )  ) 

{ 

printf ( "Touch  screen  lower  left  corner\n" ) ; 
getSOHLine (  h->tty,  h->iostat,  TSBuf Max  ); 
if (  h->iostat  [0]  —  '1'  ) 

printf  ("Touch  screen  upper  right  corner\n/' )  ; 
getSOHLine (  h->tty,  h->iostat,  TSBuf Max  ); 
if  (  h- >iostat  [0]  ==  '1'  ) 

{ 

printf ("Calibration  success\n") ; 
return  0 ; 

} 

} 

} 

printf ( "Calibration  failed\n") ; 
return  -1; 

} 

/*  warning:  NO  LOCK  means  set  commands  can  occur  while  PEN  is  down  */ 
int  tsSetScreenSize (  Touchscreen  h,  int  xmax,  int  ymax  ) 

{ 

/*  note:  no  Xlate  =>  origin  of  user  space  ==  (0,0)  */ 
h->scrX  =  xmax; 
h->scrY  =  ymax; 

h- >scaleX  =  ( (float) xmax) /TSFloatFullScale; 

h- >scaleY  =  (( float) ymax) /TSFloatFullScale ; 

} 

int  tsSetDataFilter (  Touchscreen  h,  int  distancelnScaledUnits  ) 

{ 

h->filter  =  distancelnScaledUnits; 

} 

int  tsSetAppMode (  Touchscreen  h,  int  appMode  ) 

{ 

h->appMode  =  appMode; 

} 

int  tsGetLineLength (  Touchscreen  h  ) 

{ 

return  h->lineLen; 

} 
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int  tsGetLostSyncCount (  Touchscreen  h  ) 

{ 

return  h->lostSync; 

} 

int  tsGetLine(  Touchscreen  h,  TSPoint  *line,  int  maxline  ) 

{ 

int  i ,  n ; 

TSPoint  *p ; 

if  (  h->lineLen  >  0  ) 

{ 

n  =  maxline  <  h->lineLen  ?  maxline  :  h->lineLen; 
for(  i=0,  p  =  h->line;  i<n;  i++  ) 

{ 

*line++  =  *p++; 

} 

} 

return  h->lineLen; 

} 

TSPoint  tsGetPoint (  Touchscreen  h  ) 

{ 

TSPoint  noPoint; 

if (  h->lineLen  >  0  ) return  h->line[  h->lineLen-l  ]; 
noPoint. x  =  TSNoPointExists ; 
noPoint. y  =  TSNoPointExists; 
return  noPoint; 

} 


int  t sGetPenState (  Touchscreen  h  ) 

{ 

return  h->penState; 

} 

int  tsGetLinelD (  Touchscreen  h  ) 

{ 

return  h->lineID; 

} 

int  tsGetFd(  Touchscreen  h  ) 

{ 

/*  not  implemented  yet  */ 
return  -1; 

} 

char  *tsGetLastControllerMessage (  Touchscreen  h  ) 

{ 

return  h->iostat; 

} 

int  t sOnPenDown (  Touchscreen  h,  void  (*SvcHndl) (  Touchscreen,  int,  TSPoint  ),  int 
uArg  ) 

{ 
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h- >userCBPenDown  =  SvcHndl ; 
h- >penDownCBArg  =  uArg; 

} 


int  tsOnPenContinue  (  Touchscreen  h,  void  (* SvcHndl ) (  Touchscreen,  int,  TSPoint  ), 
int  uArg  ) 

{ 

h- >userCBPenContinue  =  SvcHndl; 
h- >penContinueCBArg  =  uArg; 

} 

int  tsOnPenUp(  TouchScreen  hf  void  (*SvcHndl) {  Touchscreen,  int,  TSPoint,  int  ) , 
int  uArg  ) 

{ 

h- >userCBPenUp  =  SvcHndl; 
h- >PenUpCBArg  =  uArg; 

} 

static  int  tsDistance(  int  a,  int  b,  int  dist  ) 

{ 

int  d  =  a-b; 

iff  d<0) d  =  -d; 

return  (d>=dist)  ?  1:0; 

} 

void  t s  Se  t App Loop Abor t (  TouchScreen  h  ) 

{ 

h- >appAbortFlag  =  1; 

} 

void  tsGetPenTime (  TouchScreen  h,  int  *down,  int  *up  ) 

{ 

*down  =  h- >timePenDown ; 

*up  =  h->timePenUp; 

} 

int  ts App Loop (  TouchScreen  h  ) 

{ 

int  status ; 

for ( ; ; ) 

{ 

TSPoint  pt,  now; 
int  pen; 

iff  (h->penState  ==  TSPenStateUp)  && 

(h- >appAbortFlag  !=  0  )  ) return  TSAppLoopAbort ; 

status  =  tsGetPointBuf f er (  h,  h->iobuf,  TSBufMax  ); 
if  (  status==0  ) 

{ 

pt  =  tsBufToPoint  (  h->iobuf,  h->scaleX,  h->scaleY  ); 
pen  =  h->iobuf[0]; 

if (  (h->lineLen  >  0)  &&  (pen  1=  0)  ) 

{ 

now  =  h- >line [h- >lineLen-l] ; 

if (  tsDistance (  pt.x,  now.x,  h->filter  )  ==  0  && 

tsDistance(  pt.y,  now.y,  h->filter  )  ==  0  ) continue; 

} 

if (  pen  ==  0  ) 

{ 
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h->timePenUp  =  (int) time (0) ; 
h->penState  =  TSPenStateUp; 
h->line[  h->lineLen++  ]  =  pt ; 
if (  h- >userCBPenUp  !=  NULL  ) 

{ 

(*h- >userCBPenUp) (  h#  h- >PenUpCBArg/  pt,  h->lineLen  ); 

} 

iff  h->appMode  ==  TSAppModeReturnOnPenUp  ) return  0; 
iff  h->appMode  ==  TSAppModeReturnOnPenChange  ) return  0; 

} 

else  iff  h->penState  ==  TSPenStateUp  ) 

{ 

h->timePenDown  =  ( int ) time f 0 ) ; 
h->penState  =  TSPenStateDown; 
h->line  [  0  ]  =  pt ; 
h->lineLen  =  1; 
h->lineID  +=  1; 

iff  h- >userCBPenDown  1=  NULL  ) 

{ 

(*h->userCBPenDown) (  h,  h- >penDownCBArg,  pt  ); 

} 

iff  h- >appMode  ==  TSAppModeReturnOnPenChange  ) return  0; 

} 

else 

{ 

h->line[  h->lineLen++  ]  =  pt; 

/*  over  flow  check  on  continue  */ 
iff  h->lineLen  >=  TSLineMax  ) 

{ 

h->penState  =  TSPenStateUp; 
iff  h- >userCBPenUp  !=  NULL  ) 

{ 

(*h- >userCBPenUp) (  h,  h- >PenUpCBArg,  pt,  h->lineLen  ) 

} 

iff  h- >appMode  ==  TSAppModeReturnOnPenUp  ) return  0; 

} 

else 

{ 

h->penState  =  TSPenStateContinue ; 
iff  h->userCBPenContinue  1=  NULL  ) 

{ 

( *h- >userCBPenCont inue ) (  h,  h- >penContinueCBArg,  pt  ) 

} 

} 

iff  h->appMode  ==  TSAppModeReturnOnPenChange  ) return  0; 


else 

{ 

/*  Not  a  data  point,  probably  never  happen  */ 
strncpy (  h->iostat,  h->iobuf,  status  ); 

/*  maybe  this  is  an  error  so  return????  */ 
return  status; 

} 
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/ 


low  leT~el  utilities 


/ 


int  tsEvalBuf f er (  char  *v  ) 

{ 

return  (  ((int)v[0])  &  0x7f)  |  (  ((int)v[l])  <<  7); 

} 

TSPoint  tsBufToPoint (  char  *bf ,  float  scaleX,  float  scaleY  ) 

{ 

TSPoint  pt  ; 

pt.x  =  (int) (.5  +  (scaleX  *  ( float) tsEvalBuffer (  bf+1  ))); 
pt . y  =  (int) (.5  +  (scaleY  *  (float) tsEvalBuffer (  bf+3  ))); 
return  pt; 

} 

int  tsGetPointBuf f er (  Touchscreen  h,  char  *bf,  int  lenbuf  ) 

{ 

int  state; 
int  val; 

int  lossFlag  =  1; 
int  lossCount  =  0; 

state  =  StateSyncData; 
for  (  ;  ; ) 

{ 

val  =  wgetio(  h->tty  ); 

if (  (SYNCFLAG  &  val)  1=  0  ) state  =  StateSyncData; 
switch (  state  ) 

{ 

case  StateSyncData: 

if (  (SYNCFLAG  &  val)  !=  0  ) 

{ 

bf  [0]  =  (val  >>  6)  &  1; 
state  =  StateLsbX; 
lossFlag  =  1; 
lossCount  =  0; 

} 

else  /*  this  is  optional  logic  to  keep  track  of  lost  data  */ 

{ 

h->lostSync  +=  lossFlag; 
if  (  lossFlag  ==  0  ) 

{ 

lossCount  +=  1; 
if (  lossCount  >  4) 

{ 

lossCount  =  0; 
h->lostSync  +=  1; 


} 

lossFlag  =  0; 

} 

break; 

case  StateLsbX: 
bf  [1]  =  val ; 
state  =  StateMsbX; 
break ; 

case  StateMsbX: 
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bf  [2]  =  val ; 
state  =  StateLsbY; 
break; 

case  StateLsbY: 
bf [3]  =  val ; 

state  =  StateMsbY; 
break; 

case  StateMsbY: 
bf [4]  =  val ; 

return  0 ; 


} 

int  tsPrintDataBuf f er (  char  *bf  ) 

{ 

int  s  =  bf  [0]  ; 

int  x  =  tsEvalBuf f er (  bf+1  ); 
int  y  =  tsEvalBuf fer (  bf+3  ); 
if {  s  ==  0  ) print f ( "Up,  ") ; 
else  printf("Dn,  ")  ; 

printf("%x,  %x  —  %x  %x  %x  %x  %x\n" ,  x,  y, 

Oxf f  &  (int) bf [0] , 

Oxf f  &  (int ) bf [1]  , 

Oxf f  &  (int) bf [2]  , 

Oxf  f  Sc  (int ) bf  [3]  , 

Oxf  f  Sc  (int )  bf  [4]  )  ; 

} 

int  tsPutCmdGetReply {  Touchscreen  h,  char  *cmd  ) 

{ 

putSOHLine(  h->tty,  cmd  ); 

getSOHLine  (  h->tty,  h->iostat,  TSBufMax  ); 
return  h->iostat[0]  -  'O'; 

} 


file:  touchscreen . h 
Date:  Jan  14,  2000 

Jan  19,  2000  add  TSAppLoopAbort ,  penTime 
touch  screen  application  interface  for  MicroTouch  controller 


*/ 

#ifndef  T S_ INCLUDE  JOE F_ 

#def ine  TS_INCLUDE_DEF_ 

#include  <tspoint.h> 

/*  pen  states  */ 

#define  TSPenStateUp  1 
#define  TSPenStateDown  2 
#define  TSPenStateContinue  3 

/*  app  loop  behavior  */ 

#define  TSAppModeReturnOnlyOnError  1 
#define  TSAppModeReturnOnPenUp  2 
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#def ine  TSAppModeReturnOnPenChange  3 

/*  data  values  are  14  bits  */ 

#def ine  TSFullScale  0x3fff 

#def ine  TSFloatFullScale  (( float ) TSFullScale) 

#def ine  TSNoPointExists  -99999 
#def ine  TSAppLoopAbort  -99999 

#ifndef  TS_LIB_SYS_DEF 

typedef  struct  tsctx{int  dummy;}  TSCTX; 

#endif 

typedef  TSCTX  *  TouchScreen; 

#if def  cplusplus 

extern  "C"  { 

#endif 

Touchscreen  tsOpen(  char  *nameOf SerialPort  ); 
int  tsClose  (  Touchscreen  h  ); 
int  tsReset (  Touchscreen  h  ) ; 
int  tsDoCalibration (  Touchscreen  h  ); 

int  tsSetScreenSize (  Touchscreen  h,  int  xmax,  int  ymax  ); 
int  tsSetDataFilter (  Touchscreen  h,  int  distancelnScaledUnits  ); 
int  tsSetAppMode (  Touchscreen  h,  int  appMode  ); 
int  tsGetLineLength (  Touchscreen  h  ); 

int  tsGetLine (  Touchscreen  h,  TSPoint  *line,  int  maxline  ); 

TSPoint  tsGetPoint (  Touchscreen  h  ); 
int  tsGetPenState (  Touchscreen  h  ); 

void  tsGetPenTime (  Touchscreen  h,  int  *down,  int  *up  ); 
int  tsGetLinelD (  Touchscreen  h  )? 
int  tsGetFd(  Touchscreen  h  ); 

char  *tsGetLastControllerMessage (  Touchscreen  h  ); 
int  tsGetLostSyncCount (  Touchscreen  h  ); 

int  tsOnPenDown (  Touchscreen  h;  void  (*SvcHndl) (  Touchscreen  h, 
int  uArg,  TSPoint  now  ) ,  int  uArg  ) ; 
int  tsOnPenContinue (  Touchscreen  h,  void  (*SvcHndl) (  Touchscreen  h, 
int  uArg,  TSPoint  now  ) ,  int  uArg  ) ; 
int  tsOnPenUp (  TouchScreen  h,  void  (*SvcHndl) (  Touchscreen  h, 

int  uArg,  TSPoint  now,  int  lineLength  ) ,  int  uArg  ) 
int  t sAppLoop (  TouchScreen  h  ); 
void  tsSetAppLoopAbort (  TouchScreen  h  ); 

/*  low  level  utilities  */ 
int  tsEvalBuf f er (  char  *v  ); 

int  tsGetPointBuf f er (  TouchScreen  h,  char  *bf,  int  lenbuf  ); 
int  tsPrintDataBuf fer (  char  *bf  ); 

int  tsPutCmdGetReply (  TouchScreen  h,  char  *cmd  ) ; 

TSPoint  tsBuf ToPoint (  char  *bf,  float  scaleX,  float  scaleY  ); 
static  int  tsDistance (  int  a,  int  b,  int  dist  ) ; 

#ifdef  _ cplusplus 

} 

#endif 


#endif 


5.2  Some  Test  Programs  for  TSLIB 


file:  tstestl.c 

date:  Jan  14,  2000 

Jan  19,  2000  add  TSAppLoopAbort 

quick  api  test 

prints  x,y  on  every  pen  up 


*/ 

#include  <stdio.h> 
#include  <stdlib.h> 

# include  "touchscreen . h" 


void  PenUpCB (  Touchscreen  h,  int  unused,  TSPoint  pt ,  int  In  ); 

main (  int  argc,  char  **argv  ) 

{ 

Touchscreen  h; 
h  =  tsOpen(  "/dev/ttya"  ); 
printf (  "tstestl ,  pen  up  test\n"); 
if (  h  ! =  NULL  ) 


tsSetScreenSize (  h,  1280,  1024  ); 
tsSetDataFilter (  h,  5  ); 
tsOnPenUp(  h,  PenUpCB,  0  ); 
t  sAppLoop (  h  )  ; 
tsClose (  h  ) ; 

} 

printf ( "Bye ,  bye\n" ) ; 
exit (  0  ) ; 

} 

void  PenUpCB (  Touchscreen  h,  int  unused,  TSPoint  pt ,  int  In  ) 

{ 

int  lost  =  tsGetLostSyncCount (  h  )  ; 

printf ( "PenUp  %d  %d  n=%d,  loss=%d) \n" ,  pt.x,  pt.y.  In,  lost  ) 
/*  exit  if  we  touch  lower  right  corner  */ 
if  (  pt.x  >1260  Sc&  pt.y  <  20  ) 

{ 

tsSetAppLoopAbort (  h  ) ; 

} 

} 


/* 


file:  tstest2.c 

date:  Jan  14,  2000 

Jan  19,  2000  add  TSAppLoopAbort 

2nd  quick  api  test 

prints  x,y  on  every  pen  change 

usage:  tstest2  [f iltervalue] 
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default  filtervalue  is  5 


*/ 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  "touchscreen. h" 

/*  test  all  3  callback  functions  */ 

void  PenUpCB (  Touchscreen  h,  int  ak,  TSPoint  pt ,  int  In  ); 
void  pehDownCB (  Touchscreen  h,  int  ak,  TSPoint  pt  ); 
void  penContinueCB (  Touchscreen  h,  int  ak,  TSPoint  pt  ); 

main (  int  argc,  char  **argv  ) 

{ 

Touchscreen  h;  /*  touch  screen  context  */ 

int  k;  /*  fake  user  context  for  testing  */ 

int  filter;  /*  data  filter  distance  */ 

filter  =  5; 

if  (  argc  ==  2  ) sscanf (  argv[l],  "%d" ,  ^filter  ); 
h  =  tsOpen(  "/dev/ttya"  ); 

printf (  "tstest2 ,  pen  change  test,  filter  =%d\n" ,  filter 
k  =  0 ; 

if (  h  ! =  NULL  ) 

{ 

tsSetScreenSize (  h,  1280,  1024  ); 
tsSetDataFilter (  h,  filter  ); 

tsOnPenContinue (  h,  penContinueCB,  (int)&k  ); 
tsOnPenDownf  h,  penDownCB,  (int)&k  ); 
tsOnPenUp{  h,  PenUpCB,  (int)&k  ); 
tsAppLoop (  h  ) ; 
tsClose(  h  ); 

} 

printf { "Bye ,  bye\n" ) ; 
exit (  0  ) ; 

} 

/*  -  call  backs  ******************/ 

void  PenUpCB (  Touchscreen  h,  int  userArg,  TSPoint  pt,  int  In 

{ 

int  *k  =  (int  *) userArg; 

*k  +=  1; 

printf ("PenUp  %d  %d  n=%d,  lost=%d)\n",  pt.x,  pt.y,  In, 
tsGetLostSyncCount (h)  ); 

/*  exit  if  we  touch  lower  right  corner  */ 
if  (  pt.x  >1260  &&  pt.y  <  20  ) 

{ 

tsSetAppLoopAbort (  h  ) ; 

} 

} 

void  penDownCB (  Touchscreen  h,  int  userArg,  TSPoint  pt  ) 

{ 

int  *k  =  (int  *) userArg; 

*k  =  1  ; 

printf ( "PenDn  %d  %d) \n" ,  pt.x,  pt.y  ); 


void  penContinueCB (  Touchscreen  h,  int  userArg,  TSPoint  pt  ) 

{ 

int  *k  =  (int  *) userArg; 

*k  +=  1; 

printf ( "PenCt  %d  %d  k=%d) \n" ,  pt.x,  pt.y,  *k  ); 

} 
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